home *** CD-ROM | disk | FTP | other *** search
/ Skunkware 5 / Skunkware 5.iso / src / X11 / llnlxftp-2.0 / README < prev   
Text File  |  1995-07-14  |  10KB  |  204 lines
  1.  
  2.  
  3.                     LLNL XFTP Version 2.0,  May 26, 1994
  4.  
  5.  
  6.     **********************************************************************
  7.     **************************  ABOUT LLNL XFTP  *************************
  8.     **********************************************************************
  9.  
  10.     LLNL XFTP is a graphical user interface to FTP (File Transfer Protocol).
  11.     LLNL XFTP does not execute the ftp program; instead, it directly com-
  12.     municates with remote FTP servers.  LLNL XFTP is an X client and is
  13.     based on OSF/Motif.  LLNL XFTP enables users to transfer files and
  14.     perform various directory manipulation commands, both remotely and
  15.     locally.  Two especially notable features are the ability to (1) perform
  16.     "third-party" file transfers, and (2) transfer or delete entire directory
  17.     substructures.
  18.  
  19.     LLNL XFTP was written by Neale Smith of the Lawrence Livermore National
  20.     Laboratory, which is operated by the University of California.
  21.  
  22.  
  23.     **********************************************************************
  24.     ************************  BUILDING LLNL XFTP  ************************
  25.     **********************************************************************
  26.  
  27.     LLNL XFTP has been successfully built on the following platforms
  28.     (and a bunch of others):
  29.  
  30.           Computer            System                      Motif
  31.           --------            ------                      -----
  32.           SPARCstation        Sun OS 4.1.1                1.1.4
  33.           SPARCstation        Sun OS 4.1.3                1.2.1
  34.           DECsystem 5830      ULTRIX V4.3 (Rev. 44)       1.2.1
  35.           SGI                 IRIX 5.2                    1.2.3
  36.           SGI                 IRIX 4.0.5                  1.1.?
  37.           IBM RS6000          IBM AIX Version 3 Rel. 2    1.2.2
  38.           HP9000/735          HP-UX A.09.01               1.2.0
  39.           HP9000/735          HP-UX A.09.03               1.2.2
  40.           Cray YMP            UNICOS 6.1.6                1.1.?
  41.           DEC 4000/710        DEC OSF/1 V1.3 (Rev. 111)   1.1.2.10
  42.           Sun 4/390           Solaris 2.3                 1.2.2
  43.           Meiko               Solaris 2.1                 1.2.1/1.2.2
  44.           Convex              CONVEX OS 10.1              ?
  45.           Intel 486           BSD/386                     1.2.2
  46.           i486                System V R4.0.3             1.2
  47.           i386                SVR4                        1.2.1
  48.           ?                   SCO Open Desktop 3.0        1.2.1
  49.  
  50.     Perform the following steps to build LLNL XFTP:
  51.  
  52.     1. Enter the "sources" directory and type "xmkmf" to create "Makefile"
  53.        from "Imakefile".  If you are unable to get this to work, use the
  54.        backup makefile, "Makefile.alt", by uncommenting (and possibly
  55.        editing) the section which seems most promising for your platform.
  56.  
  57.     2. Type "make" to build the executable "xftp".
  58.  
  59.     3. Type "make install" to install the executable and the application
  60.        defaults file (the color version of the app defaults file is used).
  61.  
  62.     4. Type "make install.man" to install the man page.
  63.  
  64.     IMPORTANT: Bugs in versions of Motif earlier than 1.1.4 can cause
  65.                LLNL XFTP to  work incorrectly.
  66.  
  67.  
  68.     **********************************************************************
  69.     ********************  Application Defaults File  *********************
  70.     **********************************************************************
  71.  
  72.     It is usually not necessary to use an application defaults file with
  73.     LLNL XFTP (since LLNL XFTP contains built-in fallback values).  You may
  74.     wish to use an application defaults file with LLNL XFTP if you want to
  75.     customize certain widget attributes such as fonts or colors.  Sophis-
  76.     ticated X users can make use of the widget hierarchy that is documented
  77.     in LLNL XFTP's man pages to fine tune LLNL XFTP's appearance.
  78.  
  79.     If your X display supports color, use "XFtp.color" as LLNL XFTP's
  80.     application defaults file.  (A symbol link to XFtp.color, "XFtp.ad",
  81.     is in the "sources" subdirectory.)
  82.  
  83.     If your X display does not support color, use "XFtp.mono" as LLNL XFTP's
  84.     application defaults file.
  85.  
  86.     Change the name of "XFtp.color" or "XFtp.mono" to "XFtp" and make sure
  87.     that XFtp is in the search path of one of the X application defaults
  88.     file environment variables (e.g., XAPPLRESDIR, XFILESEARCHPATH, or
  89.     XUSERFILESEARCHPATH).  Consult the usual X documentation on how to
  90.     set and use these environment variables.
  91.  
  92.     NOTE: LLNL XFTP 2.0 is not compatible with the version 1.0 app defaults
  93.           file.  A good way to tell whether an old XFtp is being picked up
  94.           is that the view button on the main window will be labeled
  95.           "viewButton" instead of "View".
  96.  
  97.  
  98.     **********************************************************************
  99.     ***************************  Limitations  ****************************
  100.     **********************************************************************
  101.     
  102.     Here are some things to watch out for:
  103.  
  104.       (1) LLNL XFTP might not work with some old X servers.  For example,
  105.           some older OpenWindows servers might dump core.  MacX fans should
  106.           use nothing older than version 1.1.7b.
  107.  
  108.       (2) Old, buggy versions of Motif can cause weirdness.
  109.  
  110.       (3) LLNL XFTP might not work correctly with some non-Unix FTP servers
  111.           (If you can give us temporary access to such a server, we might
  112.           be able to fix the problem.)
  113.  
  114.       (4) Out-of-spec FTP servers can cause untold grief.  (Most Unix-based
  115.           servers work correctly.)
  116.  
  117.       (5) Third-party file transfers will not work unless at least one of
  118.           the remote FTP servers supports the PASV (passive) command.
  119.  
  120.  
  121.     **********************************************************************
  122.     *****************************  Support  ******************************
  123.     **********************************************************************
  124.  
  125.     Because our resources are limited, we will not be able to give you
  126.     individual assistance in building and using LLNL XFTP.  However, your
  127.     comments, suggestions and bug reports are valuable in helping us
  128.     determine how to best direct our efforts.  Our email address is
  129.  
  130.                             llnlxftp@llnl.gov
  131.  
  132.  
  133.     **********************************************************************
  134.     *************************  Acknowledgements  *************************
  135.     **********************************************************************
  136.  
  137.     Thanks to Robyne Sumpter, Sam Coleman, Mike Nemanic, Mark Seager, and
  138.     Bob Cooper for their suggestions, encouragement, and help in getting
  139.     LLNL XFTP out the door.
  140.  
  141.     Thanks to Fred Allen, Rich Fischer, Lee Busby, Mike Zollinger, and
  142.     Art Rodrigues for their help in coordinating the alpha/beta testing
  143.     of LLNL XFTP.
  144.  
  145.     Thanks to Jeff Long for his help in the design of the remote file
  146.     viewer and the anonymous FTP user interfaces.
  147.  
  148.     And thanks to the many users out there, too numerous to list, who
  149.     have sent me bug reports, suggestions and patches, and who made
  150.     valuable contributions to the debugging and testing of LLNL XFTP.
  151.  
  152.  
  153.     **********************************************************************
  154.     ************************  Copyright Notices  *************************
  155.     **********************************************************************
  156.  
  157.     (c) 1993-1994.  The Regents of the University of California.  All
  158.     rights reserved.
  159.  
  160.     This work was produced at the University of California, Lawrence
  161.     Livermore National Laboratory (UC LLNL) under contract no.
  162.     W-7405-ENG-48 (Contract 48) between the U.S. Department of Energy
  163.     (DOE) and The Regents of the University of California (University)
  164.     for the operation of UC LLNL.  Copyright is reserved to the
  165.     University for purposes of controlled dissemination,
  166.     commercialization through formal licensing, or other disposition
  167.     under terms of Contract 48; DOE policies, regulations and orders;
  168.     and U.S. statutes.  The rights of the Federal Government are
  169.     reserved under Contract 48 subject to the restrictions agreed upon
  170.     by the DOE and University.
  171.  
  172.  
  173.                            DISCLAIMER
  174.  
  175.     This software was prepared as an account of work sponsored by an
  176.     agency of the United States Government.  Neither the United States
  177.     Government nor the University of California nor any of their
  178.     employees, makes any warranty, express or implied, or assumes any
  179.     liability or responsibility for the accuracy, completeness, or
  180.     usefulness of any information, apparatus, product, or process
  181.     disclosed, or represents that its specific commercial products,
  182.     process, or service by trade name, trademark, manufacturer, or
  183.     otherwise, does not necessarily constitute or imply its
  184.     endorsement, recommendation, or favoring by the United States
  185.     Government or the University of California. The views and opinions
  186.     of the authors expressed herein do not necessarily state or reflect
  187.     those of the United States Government or the University of
  188.     California, and shall not be used for advertising or product
  189.     endorsement purposes.
  190.  
  191.     Permission to use, copy, modify and distribute this software and its
  192.     documentation for any non-commercial purpose, without fee, is
  193.     hereby granted, provided that the above copyright notice and this
  194.     permission notice appear in all copies of the software and
  195.     supporting documentation, and that all UC LLNL identification in
  196.     the user interface remain unchanged.  The title to copyright LLNL
  197.     XFTP shall at all times remain with The Regents of the University
  198.     of California and users agree to preserve same. Users seeking the
  199.     right to make derivative works with LLNL XFTP for commercial
  200.     purposes may obtain a license from the Lawrence Livermore National
  201.     Laboratory's Technology Transfer Office, P.O. Box 808, L-795,
  202.     Livermore, CA 94550.
  203.  
  204.